Software of the Month Club 1996 May/Software of the Month Club 1996 May.iso/mac/ISO9660/ZIPFILES/DRGTXT11.ZIP/DT11.003

OS/2 Help File | 1996-02-28 | 39.9 KB | 1,065 lines

ΓòÉΓòÉΓòÉ 1. Getting Started ΓòÉΓòÉΓòÉ

DragText's basic features add drag-and-drop text features to many commonly used
windows:  entryfields, listboxes, etc.  With DragText, you can copy or move
text between these windows using drag-and-drop, delete text by dragging it to
the Shredder, and enter a filename by dropping the file's icon into a window.
The basic features are offered without charge and require no registration.

DragText's extended features provide seamless integration of text with files,
directories, and WebExplorer Url objects.  Drag text to a Workplace folder to
create a file whose title is derived from the text;  drop this DragText file on
any supported window to recover the text.  You can drop a file from any source
on a multiline entryfield to insert its contents.

If the dragged text is a URL, DragText will create a WebExplorer Url object
whose title is based on the URL.  These objects can be dropped on WebEx or on
any supported window to insert the URL.

Dropping a Workplace folder on a multiline entryfield will insert a formatted
listing of the files.  The formatting is completely configurable, as are the
criteria for selecting files to be included. You can even use this facility to
write simple batch files.

The extended features are offered as shareware and require registration within
6 weeks for continued use.

DragText's features work with many commonly used applications, such as the
System Editor (e.exe) and most programs in the Internet Access Kit. It is
designed to add these features only to windows which lack them. It should never
replace or interfere with the drag-and-drop support provided by your
applications.

Because its features are added-on, not built-in, it may not work for every
possible window and conflicts may arise between DragText and some programs. If
a conflict occurs, DragText can be partially or totally disabled for that
program using the Disable page in the Options Notebook.

Installation / Removal
Running DragText
Using DragText
Options Notebook
Product Information


ΓòÉΓòÉΓòÉ 1.1. Installation / Removal ΓòÉΓòÉΓòÉ

Installation
The installation program (DTSetup.exe) will:

   - copy DragText's files to the directory of your choice
   - create a program object for DragText.exe and put it (or a shadow) in your
     Startup Folder and/or on the Desktop
   - offer you a choice of two methods for giving DragText files their own
     icon: either a Workplace class (preferred) or a program object for your
     editor
   - insert several entries in os2.ini to disable DragText for programs known
     to be incompatible, and
   - display some information specific to your system.

Removal
To remove DragText from your system, you can either:

   - run DTSetup and choose "Uninstall" to partially or completely remove it,
     or
   - simply remove the program object from your Startup Folder to keep it from
     running.

In either case, you will have to restart your system to remove it from memory
if it was previously loaded.

Running DragText
Using DragText
Options Notebook
Product Information


ΓòÉΓòÉΓòÉ 1.2. Running DragText ΓòÉΓòÉΓòÉ

The first time DragText.exe is run during a session, it loads itself into
memory, displays a copyright message for 3 seconds, and then terminates.
DrgTxt11.dll, which implements the drag-and-drop features, remains resident for
the rest of the session.  You will not see DragText in any list of windows or
tasks.

All supported windows created AFTER DragText.exe is run will provide
drag-and-drop; those created before will not (this is the primary reason for
putting DragText in your Startup Folder).

Running DragText again will bring up the Options Notebook which has pages that
let you:

   - set Options such as the default drag action
   - configure the settings for Files , Directories, and Urls
   - Disable DragText for particular programs
   - provide Info about supported windows and the icons and pointers DragText
     uses
   - get DLL info such as usage and errors, and
   - review Product Information and enter your registration number

Installation / Removal
Using DragText
Options Notebook


ΓòÉΓòÉΓòÉ 1.3. Frequently Asked Questions ΓòÉΓòÉΓòÉ

 1. Q:  Why doesn't DragText show up on my window list or task list?

    A:  DragText is NOT a task, process or window, so it won't appear in these
    lists.  Once you load it into memory (by running DragText.Exe), it stays
    there until you reboot.  (If you use Pstat or Watchcat, you will see
    DrgTxt11.Dll is in the list of dll's that have been loaded.)

 2. Q:  I completely disabled DragText for program X, but I can still drop text
    into program X's window.  Why doesn't Disable work?

    A:  You can only disable DragText for windows where DragText controls drag
    and drop.  You can tell when it is in control because the mouse pointer
    will include the letters "DT".  If you've enabled DragText's file-creation
    feature, you cannot prevent other programs from reading files it creates.
    In this case, program X is in control and will let you transfer text using
    a DragText file.

 3. Q:  I set up my mouse so the left button is the "drag button", like in
    Windows.  How come I can't drag any text?

    A:  All the windows that DragText supports use the left button to move the
    cursor and select text.  These functions completely override any drag
    function assigned to this mouse button.  IBM would have to rewrite the
    software for these windows to change this.  You can still use DragText to
    insert a file's name or contents into a window.

 4. Q:  I dropped text on the Desktop and created a file.  Later, when I
    dropped this file into my editor, the editor crashed.  What happened?

    A:  The file's name was longer than your editor could handle.  On an HPFS
    disk, a file's real name can be up to 255 characters;  the DragText default
    is 32.  You may want to shorten the names assigned to new DragText files.
    On the Files page of the  Options notebook, change the number of lines
    and/or the number of characters per line.  (This shouldn't happen on a FAT
    disk because the system shortens real names to 8 characters.)

 5. Q:  Why doesn't DragText work for one particular window in my program when
    it works for all the others.

    A:  There are at least three possible reasons:

      - your program already supports drag and drop for this window;  since
        drag and drop isn't a visible feature, you may be unaware of it;
      - the program may have installed some sort of special handling for this
        window that completely bypasses DragText;  an example of this is the
        Point Size combobox in the standard OS/2 Font dialog;
      - the program may have created a new type of window based on an existing
        type;  the new type looks and acts very much like the old type but has
        a different name, so DragText doesn't recognize it.


ΓòÉΓòÉΓòÉ 2. Using DragText ΓòÉΓòÉΓòÉ

When all features are enabled, DragText lets you use drag and drop to

   - copy, move, or delete text
   - create files and WebExplorer Url objects
   - insert the contents of files and Url objects in text windows
   - create a formatted listing of a folder's directory

To help you identify the results from a drag and drop operation, DragText uses
up to six icons and three pointers.  These results can be changed by using
modifier keys or by setting DragText's default actions to suit your needs.  All
of this is explained in detail in the following sections.

   - Text, Urls, Files, and Folders

   - Icons and Pointers

   - Modifier Keys and Defaults

   - Supported Windows

Options Overview
Files Overview
Getting Started
Running DragText


ΓòÉΓòÉΓòÉ 2.1. Text, Urls, Files, and Folders ΓòÉΓòÉΓòÉ

Dragging Text
To drag text out of any supported window , highlight it, then begin dragging
from anywhere within the window. (Note: for single-line Entryfields begin
dragging without any highlighting to drag the entire contents of the field.)

As you move the pointer over different windows, the icon and pointer will
change to indicate what will happen if you drop the text at that point. Over a
DragText-enabled window, the text will be inserted into editable fields and
matching text will be selected in listboxes and readonly spinbuttons (see
restrictions below). You can delete text by dragging it to the Shredder.

When the Extended features are enabled, dropping text into a Workplace folder
will create a file, or a WebExplorer Url object if the text was a Url.  You may
also be able to insert text into a window that is not DragText-enabled if the
program permits you to drop a file on it.

Dragging Files and Folders
With the Basic features, you can drop a file or folder into any supported
window to insert its fully-qualified name.  Using the Extended features, you
can drop a DragText-created file into any window to insert its text.  You can
also insert the contents of any file into a multiline entryfield by pressing
Alt before you drop it.  Press Alt before you drop a folder to insert a
formatted listing of its directory.  The formatting is controlled by the
settings on the Directory Options page (Files->Dirs) of the Options notebook.

Restrictions:  While you can copy text from any supported window , you can only
move or delete text from editable windows (i.e. those which aren't read-only or
listboxes).  Similarly, you can only move text into editable windows.  To
comply with CUA standards, you cannot copy text onto itself;  you can override
this by pressing Ctrl before you drop. Also, you can only drop one file icon
into a window at a time.

Using DragText
Icons and Pointers
Modifier Keys and Defaults


ΓòÉΓòÉΓòÉ 2.2. Icons and Pointers ΓòÉΓòÉΓòÉ

DragText changes icons as you drag to show what will happen if you make a drop.
It uses mouse pointers to indicate whether DragText itself controls what will
happen.

Pointers
Whenever you drag text or a file over a window that DragText controls, the
mouse pointer will always include the letters 'DT', and DragText will decide
whether a drop is permitted.  If the pointer does not say 'DT', the program
that owns the window is in control and it determines whether a drop is
acceptable.  In this case, there is nothing DragText can do to prevent the
program from accepting a drop.

DragText uses three pointers:

          Insert - text will be inserted into editable fields; text will be
          matched and selected in listboxes and spinbuttons
          Replace - used only for single-line entryfields to indicate that
          dropped text will completely replace the current contents.  Press and
          release the Insert key in a normal fashion to toggle between insert
          and replace.
          Illegal - DragText will not permit a drop

Icons
With all Extended Features enabled, DragText switches among six different
icons. If only the Basic Features are enabled, it uses two.  This feature is
disabled if you have one of the original versions of OS/2 Warp because of a bug
in them (see Change Icons for more information).

DragText uses these icons:

          Text - text will be inserted into editable fields; matching text will
          be selected in listboxes and readonly spinbuttons [Basic and Extended
          features]. This icon is also used when you drag a DragText-created
          file over any DragText-enabled window [Extended features].

          Note:  if Change Icons is disabled, this is the only icon that will
          be used.
          File - this icon never appears over a DragText-enabled window.  Over
          the Workplace Shell, a drop will create a file; elsewhere, text will
          be transfered to the target program via a file [Extended features].

          WebExplorer Url (not shown here) - if the text you are dragging is a
          URL, this icon appears after you leave a DragText window.  Over the
          Workplace Shell, a drop will create a WebExplorer Url object;
          elsewhere, text will be transfered to the target program via a file
          [Extended features].
          File Name - when you drag a file or folder over a DragText window,
          this icon replaces the original to show that the file or folder's
          fully qualified name will be inserted [Basic and Extended features].
          File Contents - appears only when dragging a file over a multiline
          entryfield (you may have to press the Alt key).  The file's contents
          will be inserted [Extended features].
          Folder Contents - appears only when dragging a folder over a
          multiline entryfield (you must press the Alt key).  A listing of the
          folder's contents will be inserted [Extended features].

Using DragText
Text, Urls, Files, and Folders
Modifier Keys and Defaults


ΓòÉΓòÉΓòÉ 2.3. Modifier Keys and Defaults ΓòÉΓòÉΓòÉ

Modifier Keys
DragText uses standard modifier keys and adds two others to override the
default action.  Except for the Insert key, press and hold them before you
drop, NOT when you begin a drag. For Insert, press and release immediately
while over an entryfield;  do NOT hold it down.

Ctrl

   - copy text and DragText files
   - copy text onto itself
   - for files, insert the file's formatted directory entry rather than its
     fully-qualified name (this usage may change in future versions)

Shift

   - move text
   - copy a DragText file then delete it
   - you can never move folders or files from other sources

Alt

   - over multiline entryfields only, insert a file's contents
   - over multiline entryfields only, insert a folder's directory listing

Insert

   - over a single-line entryfield, toggle between inserting the dropped text
     into the current contents, and replacing the current contents with the
     dropped text.

Defaults
In all cases, the default operation is Copy.  You can change these defaults:

On the Options page

   - copy/move text within a window
   - copy/move text between windows
   - insert/replace text in entryfields

On the Files page:

   - copy/move text from a window into a DragText file
   - copy/move a DragText file into a window
   - insert a file's name/contents into a multiline entryfield

Using DragText
Text, Urls, Files, and Folders
Icons and Pointers
Options Overview
File Overview


ΓòÉΓòÉΓòÉ 2.4. Supported Windows ΓòÉΓòÉΓòÉ

DragText works with six commonly-used types of windows found in most every
application.  They may be used as the app's main window, or only in its dialogs
and notebooks.  An example of each window appears on the Info page in the
Options Notebook

Entryfield
usually contains a single piece of information, such as a filename.

o to drag the entire contents, don't highlight any text, just drag
o to replace the entire contents, quickly press and release the Insert key
  while over the field.  The mouse pointer will change to show that you're in
  Replace mode.

Multi-line Entryfield
often used as the main text window in simpler apps such as the System Editor.

o insert the contents of any file by pressing the Alt key before you drop the
  file's icon.
o enter a formatted listing for a directory by pressing the Alt key before you
  drop the folder's icon (see Directory Listing Options for details).

Listbox
dropping text will cause DragText to search for a matching item. If found, it
will be selected (highlighted); if not, you'll hear a beep. DragText will never
insert text into a listbox.

Combobox
combines an entryfield with a listbox.  DragText handles each part as if it
were a stand-alone window, with one exception. If the entryfield is read-only,
dropping text on it will cause a search of the listbox for a matching entry

Spin Button
combines an entryfield with a button.  If the entryfield part can be edited, it
will be handled like a stand-alone entryfield.  If it is read-only, DragText
will search for a matching item. If found, it will be displayed; otherwise,
you'll hear a beep.

Static Text
used to display text that can't be edited, such as labels and error messages.
You can drag text from static text windows but you can never drop anything on
them.

Note:  You should be aware that some programs create their own window-types
that closely resemble the standard ones.  DragText does not support these
look-alikes.

Getting Started
Using DragText
Options Notebook


ΓòÉΓòÉΓòÉ 3. Options Notebook ΓòÉΓòÉΓòÉ

Whenever you need to change DragText's defaults or get help on using it, run
DragText to open its Options Notebook.  There are four major sections, each
with a tab at the top of the notebook:

 Options     set the default actions for DragText's Basic features.

 Files       set the default actions for DragText's extended features.

 Disable     restrict DragText's operation for any programs you specify.

 Info        get quick help, review error messages, enter your registration
 All settings take effect as soon as you press the "Apply" button, change pages
in the notebook, or close it.


ΓòÉΓòÉΓòÉ 3.1. Options ΓòÉΓòÉΓòÉ

The Options page lets you set the default actions for DragText's Basic
features. All settings take effect as soon as you press the "Apply" button,
change pages in the notebook, or close it.

Drag Defaults
Miscellaneous Options
Reset Notebook


ΓòÉΓòÉΓòÉ 3.1.1. Drag Defaults ΓòÉΓòÉΓòÉ

Between Windows
when dragging text from one window to another, this determines whether the
default action will be to copy or move the text

Within a Window
when dragging text from one part of a window to another, this determines
whether the the text will be copied or moved

These defaults can be overridden by pressing the Ctrl key (to copy) or the
Shift key (to move).

Note:  In many situations, a move operation is not possible.  If the default is
set to move, the text will be copied instead. If you explicitly request a move
by pressing the Shift key, the operation will be refused.

Drops into entryfields
When you drop text from another window into an entryfield (or the entryfield
portion of a combobox or spin button), you can choose to have it:

   - inserted into the existing text (the initial setting)
   - completely replace the existing text (the recommended setting)

When set to insert, DragText's 'I-beam' mouse pointer will be used.  When set
to replace, the mouse pointer will change to an I-beam followed by three X's.
(See Icons and Pointers ) In use, press and immediately release the Insert key
while over an entryfield to toggle between insert and replace.  You must be
over a DragText-enabled window when you press Insert to avoid changing the
system's global insert state.

Options Overview
Miscellaneous Options
Reset Notebook


ΓòÉΓòÉΓòÉ 3.1.2. Miscellaneous Options ΓòÉΓòÉΓòÉ

Error notification
This determines whether DragText notifies you when it encounters an error. When
set to Beep, DragText will make a distinctive two-note beep. This is the
initial and recommended setting.  When set to None, DragText will not notify
you.

In any case, the most recent error message can be viewed on the DLL Info page.

Change Icons
When you drag text or files over a DragText window, DragText can change the
dragged icon to give you a better idea of what will happen if you drop it.
Unfortunately, all of the original releases of OS/2 Warp v3.0 have a bug that
will cause a crash if the source and target windows belong to different
applications. This was corrected by Warp Fixpacks 8 and later (Fixpack 17 was
the latest available, as of February, 1996).  This is also fixed in v3.01.

At startup, DragText examines the "buildlevel" of PMMERGE.DLL to see if this
fix is installed and then enables or disables this feature accordingly.  The
results of its findings are displayed here (either auto-detect = yes or
auto-detect = no). If DragText misidentifies the buildlevel, you can override
it with this setting.  To identify the buildlevel yourself, enter "ver /r" at
an OS/2 command prompt.  This feature should be enabled if the buildlevel is
8.232 or higher.

   - auto-detect:  DragText will perform the check described above.  This is
     the default.
   - yes:  change icons, regardless of the build level.
   - no:  do not change icons, regardless of the build level.

Cache Icons
DragText doesn't load an icon until it is needed.  It can then save it for
later use or it can delete it to free up memory.  Unless you run many programs
simultaneously and are short of memory, you should probably leave caching
enabled.

   - yes:  leave icons in memory; this is the default.
   - no:  delete the icon after use; this will free all icons, including those
     previously cached.

Options Overview
Drag Defaults
Reset Notebook


ΓòÉΓòÉΓòÉ 3.1.3. Reset notebook to default size ΓòÉΓòÉΓòÉ

Each time you close the Options Notebook, DragText saves its current size,
position, and display attributes (e.g. the font used for notebook tab text).
Use this checkbox to restore all of these to their default values the next time
you run DragText.exe.  This is particularly useful if you change display
resolutions.

Options Overview
Drag Defaults
Miscellaneous Options


ΓòÉΓòÉΓòÉ 3.2. Files ΓòÉΓòÉΓòÉ

The pages in the Files section of the notebook let you set the default actions
for DragText's extended features.  All settings take effect as soon as you
press the "Apply" button, change pages in the notebook, or close it.

File Options
WebExplorer Url Defaults
Directory Listing Options
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.1. File Options ΓòÉΓòÉΓòÉ

File and Url Titles

Lines:  the maximum number of lines the title will use when displayed in a
Workplace folder

Chars:  the maximum number of characters in each line

+/- Chars:  DragText can add or subtract this many characters to a line to
avoid splitting a word in two

Replace punctuation with:  this character will replace one or more consecutive
spaces, punctuation, and control characters in file titles (but not in Url
titles)

DragText Files
This applies to the files DragText creates.  You can override these settings by
pressing Shift to move or Ctrl to copy.

Text to File:  when you drop text on the Workplace to create a file, you can
either copy or move (i.e. delete) the text from the source window

File to Text:  when you drop a DragText file on a supported window, you can
either copy or delete (i.e. move) the file

Other Files
These are files DragText did not create.  You can toggle this setting by
pressing Alt.

Other Files to MLEs:  when you drop a file DragText didn't create on an MLE
(multi-line entryfield), DragText will insert either the file's complete name
or the file's contents. If it inserts the contents, DragText will rplace all
nulls with spaces and remove any trailing end-of-file (Ctrl-Z) character.

Create Files
Check this box to enable DragText to create files.

Read Files
Check this box to enable DragText to read files and subdirectories.

Files Overview
WebExplorer Url Defaults
Directory Listing Options
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.2. Directory Listing Options ΓòÉΓòÉΓòÉ

If you drop a Workplace folder on a multiline entryfield while pressing Alt,
DragText will insert a formatted listing of the files in that disk directory.
This listing will not include non-file objects (such as program objects or
shadows).  This feature can be used to create simple batch files, as shown in
Example 2 below.

Include:  like any request for a directory listing, this determines which files
will be included.  The default is "*"  which includes all files.  You could
change this to "*.exe" to include only programs, or to "a*" to include only
files whose names begin with the letter "a".

Flags:  this lets you include or exclude files based on their standard
attributes: Directory, Read-only, Archived, Hidden, and System.  Plus ("+")
includes files with that attribute while minus ("-") excludes files with the
attribute. Equal ("=") requires a file to have the attribute to be included.
The default value of all pluses includes all files.  Setting the flags to "+D
-R +A =H +S" would produce a listing of hidden files that weren't also
read-only

Listing Format:  controls the formatting for each file in the listing.  You can
enter meta-characters (see below), fixed text, tabs, and carriage returns.
(Note: you must include a carriage return if you want each entry to appear on a
separate line.)  The default value is "%#  %d  %t %s %a %f" , followed by a
carriage return.  If you erase the contents of this field, DragText will fill
in the default value;  it cannot be left blank.

Heading Format:  produces a heading for your listing.  You may include fixed
text, control characters, and the meta-characters for the path and file.  The
file meta-character will be replaced by the search string.  If this field is
left blank, no heading will be produced.

Meta-Characters
These represent the various components of a directory listing:

%p        pathname as it appears on the disk with both upper and lowercase
          letters
%P        pathname with all letters converted to uppercase

%f        filename as it appears on the disk with both upper and lowercase
          letters
%F        filename with all letters converted to uppercase

%n        filename without its extension with both upper and lowercase letters
%N        filename without its extension with all letters converted to
          uppercase

%e        filename extension with both upper and lowercase letters
%E        filename extension with all letters converted to uppercase

%d        file date (same as %D) using your country's standard format
%D        file date (same as %d) using your country's standard format

%t        file time as HH:MM (plus AM or PM if you use a 12-hour clock)
%T        file time as HH:MM:SS (plus AM or PM if you use a 12-hour clock)

%s        file size to a maximum of 7 digits;  if the size is 10 million or
          more, this field will contain 7 asterisks (i.e. "*******")
%S        file size to a maximum of 10 digits

%a        file attributes (including the directory flag) in lowercase letters
%A        file attributes (including the directory flag) in uppercase letters

%#        the sequence number of this entry, starting at 1

%%        used to include a percent sign in your fixed text

Note:  the pathname will not include a final backslash unless it is immediately
followed by the filename

Example 1 - verbose listing

[Heading]  Directory listing for %p
[Listing]  File %F was created on %d at %T

[Output]  Directory listing for C:\DragText
      File DRAGTEXT.EXE was created on 12-25-95 at 01:10:00
      File DRAGTEXT.DLL was created on 12-25-95 at 01:10:00
      [etc.]

Example 2 - creating a batch file

[Heading]  cd %p
[Listing]  ren %f %F

[Output]  cd C:\DragText
      ren DragText.Exe DRAGTEXT.EXE
      ren DragText.Dll DRAGTEXT.DLL
      [etc.]

Files Overview
File Options
WebExplorer Url Defaults
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.3. Set WebExplorer Url Defaults ΓòÉΓòÉΓòÉ

This feature works even if you do not have IBM's WebExplorer.

Create WebExplorer Urls
When checked, DragText will create WebExplorer_Url objects if that Workplace
class is registered.  If it is not registered, DragText will create a file that
is functionally identical to the object, except for the class-specific settings
notebook.  Either can be dropped on the WebExplorer to load a Url. If this box
is not checked, DragText will handle Urls like any other dragged text.

Url Identifiers
When the beginning of your text matches one of these prefixes, DragText creates
a Url object.  The default values are "http:// ftp://" .  You can add any
identifier that WebExplorer supports;  for example, you could add "gopher://".
Separate each identifier with a space.

DragText can also recognize incomplete Urls and fill in the missing identifier.
Enter the identifier surrounded by angle brackets ('<' and '>'), followed by
the letters DragText should try to match. The default values are "<http://>www.
<ftp://>ftp." .  Notice that each ends with a period:  this should keep
DragText from misidentifying sentences beginning with these letters.

Title Options
DragText uses these options, plus its own rules, to format the Url as a title.
They do not affect the object's contents.

Remove from Hostname:  to provide shorter and more meaningful titles, you can
have DragText remove unnecessary words from the hostname portion of the Url.
Each portion of the name, delimited by a dot or a slash, is compared to this
list;  if it matches, the word is eliminated.  The wildcard characters '*' and
'?' can be used.  The default values are "www* com net edu org ??" .  Using
"www*" will remove "www", "www1", "www-os2", etc.  Using "??" will remove all
two-letter words, such as country identifiers (e.g. "ca" or "de").

Line break after hostname:  when checked, only the hostname will appear on the
first line of the title. Any path information will begin on the second line.
If the hostname is long enough to wrap to line 2, no line break will be added.

Hostname only:  when checked, the Url title will include only the hostname.  No
path information will appear in the title.

Files Overview
File Options
Directory Listing Options
Compatibility Options (Fixes)


ΓòÉΓòÉΓòÉ 3.2.4. Compatibility Options (Fixes) ΓòÉΓòÉΓòÉ

For an add-on like DragText to work with a wide range of programs, some
compromises may have to be made.  These options should be set to meet the needs
of your most commonly used applications.

Temporary Files
These settings have NO effect on your ability to create files by dropping text
on a Workplace folder. DragText's ability to create files lets you insert text
into programs that otherwise wouldn't accept dragged text.  Sophisticated
programs like the Enhanced Editor (EPM) understand that they should ask
DragText to create a file.  Simpler applications don't know how to ask and may
complain or crash if the file doesn't exist yet.  To avoid this, you can have
DragText create a file as soon as you begin a drag.  Because DragText uses a
separate thread to create the file, this shouldn't have a significant impact on
overall performance.

When drag starts:

   - (no temp file):  this is the default setting and best if your apps will
     accept dragged text directly.
   - create a file:  this is the most reliable setting for transferring text
     via a file.  However, there will be background disk activity whenever you
     begin a drag.
   - create a pipe:  this setting, in effect, creates a file in memory.
     Programs that examine a file's attributes or size before loading may have
     problems using a pipe.

File/Pipe Name:  the name DragText uses when creating a file or pipe; it is
reused every time you begin a drag.  The name must conform to the 8.3 naming
convention.  The default value is "DRAGTEXT.TMP".

File Path:  the disk directory where the temporary file is stored.  The default
value is the directory where DragText.Exe is stored.

WebExplorer URLs

Drop URLs directly into WebEx:  when checked, you can drag a Url directly from
a DragText-enabled window and drop it on the WebExplorer to load it.  A
temporary file will always be created, regardless of the settings described
above.  You will also be unable to use this file to insert text into a program
that isn't DragText-enabled.

Note:  The File Path you set for DragText's temporary files must be on the same
disk as WebExplorer when you use this option.

Files Overview
File Options
WebExplorer Url Defaults
Directory Listing Options


ΓòÉΓòÉΓòÉ 3.3. Disable ΓòÉΓòÉΓòÉ

The Disable page lets you restrict DragText's operation for any programs you
specify.

Normally, DragText is enabled for all programs.  However, if it conflicts with
an application's use of drag-and-drop, you can partially or totally disable
DragText for that program.

The "Program" section of the dialog contains a list of all applications that
currently have restrictions. The checkboxes under "Uncheck to Disable" show the
window types on which DragText operates.  If a box is checked, DragText is
enabled.

If DragText's extended features are enabled, you can disable them for a
specific program. Uncheck Drag to disable file and WebExplorer Url creation;
uncheck Drop to disable reading files, directories, and Url objects.

Important:  you can only disable file operations for DragText-enabled windows.
These are windows where the mouse pointer changes to one of DragText's unique
pointers (see Icons and Pointers for details).  You cannot prevent a program
that accepts dropped files from accepting text rendered as a file or Url
object.  For example, if you drag a Url from a DragText window, you cannot
prevent WebExplorer from accepting it because DragText does not control WebEx's
drag and drop features.

Add a Program to the Restricted List
Change a Program's Restrictions
Remove a Program from the List

Notes:

o Restrictions are checked when a program is launched, not during its
  execution.  To add a restriction, close the application program, add the
  restriction, then restart the program.
o Only programs with restrictions are saved.  Programs whose settings match the
  default (no restrictions) will be dropped from the list and will not appear
  next time you run DragText.  This is done to enhance DragText's performance.

Conflicts with Other Programs
Disabling DragText System-wide
Getting Started
Using DragText


ΓòÉΓòÉΓòÉ 3.3.1. Conflicts with Other Programs ΓòÉΓòÉΓòÉ

DragText knows very little about the programs it works with and they know
absolutely nothing about DragText.  Because of this, conflicts are possible -
particularly with applications that have their own drag and drop functions.

DragText can usually tell when a program is handling drag and drop and avoids
getting involved.  When this fails, you may get an error message or unexpected
results.

To eliminate this problem, use the Disable page to disable DragText partially
or totally for that program.  It usually isn't necessary to disable DragText
totally;  in most cases, disabling the particular type of window that is
causing trouble will suffice.  You may find that disabling only drags or only
drops for that window will solve the problem.

Restrictions are checked when a program is launched, not during its execution.
To add a restriction, close the application program, add the restriction, then
restart the program.

Note:  Most error messages arise from other problems in the system and are not
directly the result of a conflict between DragText and your application
program.

Disable Overview
Running DragText


ΓòÉΓòÉΓòÉ 3.3.2. Add a Program to the Restricted List ΓòÉΓòÉΓòÉ

Enter the name of the program (or drop its icon into the entryfield).  Path
information is not needed and will be removed when you add this entry.

To disable drag and/or drop for particular window types, uncheck the
corresponding boxes.  To disable DragText entirely uncheck "All Windows".

Press the button labeled "Add".

Change a Program's Restrictions
Remove a Program from the List


ΓòÉΓòÉΓòÉ 3.3.3. Change a Program's Restrictions ΓòÉΓòÉΓòÉ

Select the program from the list.  The checkboxes will show its current status.

Make any necessary changes.

Your changes will be saved when you select another program from the list, press
the "Apply" button, change notebook pages, or exit.

Add a Program to the Restricted List
Remove a Program from the List


ΓòÉΓòÉΓòÉ 3.3.4. Remove a Program from the List ΓòÉΓòÉΓòÉ

Select the program from the list.  The checkboxes will show its current status.

Press the "Remove" button.  The entry will be deleted immediately.
-- or --
Check all of the checkboxes (i.e. so that there are no restrictions). The entry
will be deleted when you close the notebook.

Add a Program to the Restricted List
Change a Program's Restrictions


ΓòÉΓòÉΓòÉ 3.3.5. Disabling DragText System-wide ΓòÉΓòÉΓòÉ

DragText uses only documented features of OS/2 which should continue to be
supported in future versions. Still, it is possible that unforeseen changes to
the operating system will render DragText incompatible with a particular type
of window.  To retain the bulk of DragText's usefulness, you can disable that
window type system-wide.

On the Disable page, enter <ALL PROGRAMS> (the angle brackets are required).
Uncheck both boxes for this window type, then press the "Add" button.  This
option will be in effect for all newly launched programs;  those which are
already running will not be affected.

In extraordinary circumstances, you may find it necessary to disable DragText
for all new windows in all programs.  To do this, follow the instructions
above, but uncheck both boxes next to "All Windows".  In this case, DragText
will be disabled for all new windows, including those created by programs that
are already running.  Windows that already exist will not be affected.


ΓòÉΓòÉΓòÉ 3.4. Info ΓòÉΓòÉΓòÉ

 Info     practice your drag and drop using examples of each supported window

 Icons    view each of the icons and pointers used as you drag text and files

 DLL      review usage statistics and error messages

 DT       enter your registration number, review product info


ΓòÉΓòÉΓòÉ 3.4.1. DLL Info ΓòÉΓòÉΓòÉ

The DLL Info page provides usage and error statistics for DragText.dll.

Usage
The usage section shows the number of processes (programs) that have loaded
DragText.dll and the number currently using it. The latter figure will usually
be at least 3 (two instances of pmshell.exe and DragText.exe itself).

Errors
This section displays the total number of errors encountered during this
session, the ID number of the last process to have an error, and the message
associated with that error.

When an error occurs, DragText.dll will notify you by whichever method you
choose on the Options page.  You can restart DragText.exe and refer to this
page to review the error message.

Note:  These messages are intended for debugging and diagnostic purposes.
Except for identifying conflicts with other programs, they are of little use to
the user.  All errors arise from flaws in DragText, other applications, or the
operating system. Users cannot "cause" errors.

Conflicts with Other Programs
Options Overview
Getting Started


ΓòÉΓòÉΓòÉ 3.4.2. Registration Information ΓòÉΓòÉΓòÉ

After you register DragText uou will receive a registration number.  Enter it
on the last page (Info->DT) of the Options Notebook.  Enter your name exactly
as it appears on your registration notice.  Close the notebook, then reopen it
to reset your options.

Product Information
Registering DragText
License Agreement
Options Notebook


ΓòÉΓòÉΓòÉ 4. About DragText ΓòÉΓòÉΓòÉ

                            - DragText version 1.1 -
                       The Drag and Drop Enabler for OS/2*

                       (C) Copyright R L Walsh 1994, 1995
                              All rights reserved.

                                    write to
                               [e-mail]
                                    -- or --
                                   Rich Walsh
                                315 S. Barbour St
                          Beverly Hills, Florida 34465
                                     U.S.A.

                              Registering DragText
                                License Agreement

* OS/2 is a registered trademark of International Business Machines Corp.


ΓòÉΓòÉΓòÉ 4.1. Registration ΓòÉΓòÉΓòÉ

To continue using DragText's Extended features after your 6-week free trial
ends, register it directly with the author ($15) or through BMT Micro ($18).
You will receive a registration number to enter on the last page of the Options
Notebook.

Direct  - $15 (US)
Mail a check or money order drawn in *US Dollars* to:

   Rich Walsh
   315 S. Barbour St.
   Beverly Hills, Florida  34465
   U.S.A.

Include your full name, mailing address, and email address (if available).
Send email to:  [e-mail]

 BMT Micro  - $18 (US)

Phone:         8:00am - 7:00pm EST (-5 GMT)
               [phone] (Orders only)
               [phone] (Orders / Order Inquires)

Fax:           [phone] hours, 7 days a week
               [phone] 24 hours, 7 days a week

BBS:           [phone] 10 lines, all 14.4K
               [phone] 28.8k v.FC

Internet:      [e-mail]

Compuserve:    Thomas Bradford, 74031,307

telnet:        bmt.wilmington.net

BMT Micro accepts Visa, Mastercard, Discover, American Express, Diner's Club,
money order, cashiers checks, and personal checks. They also accept DM and
British currency via registered mail. Personal checks are subject to clearance.

BMT Micro accepts purchase orders from educational institutions, governmental
agencies and other verifiable businesses.  Terms are "Due Upon Receipt" with a
$250 minimum.

Entering your registration number
Product Information
License Agreement
Options Notebook


ΓòÉΓòÉΓòÉ 4.2. License Agreement ΓòÉΓòÉΓòÉ

DragText, its executables and documentation, is the copyrighted property of
Richard L. Walsh. It is licensed, not given, to you for your personal use.
Selected features require the payment of a registration fee for continued use.

You may copy and freely redistribute DragText to others, provided:

   - the recipient agrees to the terms of this license,
   - you transfer DragText as a whole and intact,
   - there is no cost to the recipient other than the costs of providing media
     and transmission, and
   - it is not redistributed in conjunction with any software that may not also
     be freely redistributed by the recipient.

You may not modify DragText in any way nor may you reverse assemble, reverse
compile, or otherwise translate or reverse engineer its executable code or
data. You may make additions to the documentation, including translations into
other languages, provided these are contained in files separate from the
originals and are identified as addenda to the accompanying original
documentation.

DragText is not warranted to be free of defects nor to be suitable for any
particular purpose the licensee may put it to. The licensee agrees to use
DragText at his or her own risk, and agrees to accept all liabilities arising
from its use, including all claims by third parties, without recourse to the
author or copyright holder.

THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY SORT. BY YOUR USE OF THE
PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE.

Product Information
Registering DragText
Options Notebook